home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.2 for Intel / NeXTSTEP 3.2 for Intel.iso / NextLibrary / Documentation / Sybase / DBLIB / Section3 / bcp_setl.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.4 KB  |  57 lines
  1. .Na "BCP_SETL"
  2. .mc |
  3. .Aa
  4. .Fu
  5. Set the LOGINREC for bulk copy operations.
  6. .Ih "bcp, set the LOGINREC"
  7. .Ih "LOGINREC, set for bulk copy"
  8. .Sy
  9. .Sf "RETCODE BCP_SETL(loginrec, enable)"
  10. .Sp "LOGINREC" "*loginrec"
  11. .Sp "DBBOOL" "enable"
  12. .Co
  13. .Bl
  14. This macro sets a field in the LOGINREC
  15. structure that tells \*S that the DBPROCESS connection may
  16. be used for bulk copy operations.
  17. For it to have any effect, it must be called before \f2dbopen()\f1,
  18. the routine that actually allocates the DBPROCESS structure.
  19. .Bl
  20. Applications that allow users to make ad hoc queries
  21. may want to avoid calling this macro (or to call it with
  22. the \f2enable\f1 parameter FALSE), in order to keep users from
  23. initiating a bulk copy sequence via SQL commands. Once a bulk copy
  24. sequence has begun, it cannot be stopped via an ordinary SQL command.
  25. .Bl
  26. For information on the \f2bcp\f1 utility program, see its manual page
  27. in the \f2Commands Reference\f1.
  28. .Bz
  29. .Pa
  30. .Pi loginrec
  31. This is a pointer to a LOGINREC structure, which will 
  32. be passed as an argument to \f2dbopen()\f1. You can get one by
  33. calling \f2dblogin()\f1.
  34. .Pi enable
  35. This is a Boolean value (TRUE or FALSE), which specifies
  36. whether or not to enable bulk copy operations for
  37. the resulting DBPROCESS. By default, DBPROCESSes are \f2not\f1
  38. enabled for bulk copy operations.
  39. .in -.375i
  40. .Re
  41. .br
  42. SUCCEED or FAIL.
  43. .Sa
  44. bcp_init, 
  45. dblogin, 
  46. dbopen,
  47. DBSETLAPP, 
  48. DBSETLHOST, 
  49. DBSETLPWD, 
  50. DBSETLUSER
  51. .mc
  52. .rs
  53. .bp
  54. .KS
  55. .sp 2
  56. .KE
  57.